
<!DOCTYPE html>

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta charset="utf-8" />
    <title>ambient.Profile.extend_profile_deeper &#8212; Texas A&amp;M Oil spill / Outfall Calculator 2.1.0 documentation</title>
    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
    <script id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></script>
    <script src="../../_static/jquery.js"></script>
    <script src="../../_static/underscore.js"></script>
    <script src="../../_static/doctools.js"></script>
    <script src="../../_static/language_data.js"></script>
    <link rel="index" title="Index" href="../../genindex.html" />
    <link rel="search" title="Search" href="../../search.html" />
    <link rel="next" title="ambient.Profile.get_units" href="ambient.Profile.get_units.html" />
    <link rel="prev" title="ambient.Profile.close_nc" href="ambient.Profile.close_nc.html" />
   
  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
  
  
  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />

  </head><body>
  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          

          <div class="body" role="main">
            
  <div class="section" id="ambient-profile-extend-profile-deeper">
<h1>ambient.Profile.extend_profile_deeper<a class="headerlink" href="#ambient-profile-extend-profile-deeper" title="Permalink to this headline">¶</a></h1>
<dl class="method">
<dt id="ambient.Profile.extend_profile_deeper">
<code class="sig-prename descclassname">Profile.</code><code class="sig-name descname">extend_profile_deeper</code><span class="sig-paren">(</span><em class="sig-param">self</em>, <em class="sig-param">z_new</em>, <em class="sig-param">nc_name=None</em>, <em class="sig-param">h_N=1.0</em>, <em class="sig-param">h=0.01</em>, <em class="sig-param">N=None</em><span class="sig-paren">)</span><a class="reference internal" href="../../_modules/ambient.html#Profile.extend_profile_deeper"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#ambient.Profile.extend_profile_deeper" title="Permalink to this definition">¶</a></dt>
<dd><p>Extend the CTD profile to the depth <cite>z_new</cite> using a fixed buoyancy
frequency</p>
<p>Extends the depth of a CTD profile to the new depth <cite>z_new</cite> using a 
fixed buoyancy frequency to adjust the salinity and keeping all other
variables constant below the original depth.  This should only be 
used when no ambient data are available and when the bottom of the 
original profile is deep enough that it is acceptable to assume all 
variables remain constant in the extention except for salinity, which 
is increased to maintain the desired buoyancy frequency.</p>
<p>The fixed buoyancy frequency used to extend the profile can be 
specified in one of two ways:</p>
<ol class="arabic simple">
<li><p>Specify <cite>h_N</cite> and <cite>h</cite> and let the method <cite>buoyancy_frequency</cite> 
evaluate the buoyancy frequency.  The evaluation depth is taken at
the fraction <cite>h_N</cite> of the original CTD depth range, with 
<cite>h_N</cite> = 1.0 yielding the lowest depth in the original CTD profile.
<cite>h</cite> is passed to <cite>‘buoyancy_frequency</cite> unchanged and sets the 
length-scale of the finite difference approximation.</p></li>
<li><p>Specify <cite>N</cite> directly as a constant.  In this case, the method
<cite>buoyancy_frequency</cite> is not called, and any values passed to 
<cite>h_N</cite> or <cite>h</cite> are ignored.</p></li>
</ol>
<dl class="field-list simple">
<dt class="field-odd">Parameters</dt>
<dd class="field-odd"><dl class="simple">
<dt><strong>z_new</strong><span class="classifier">float</span></dt><dd><p>New depth for the valid_max of the CTD profile</p>
</dd>
<dt><strong>nc_name</strong><span class="classifier">string or path, default=None</span></dt><dd><p>Name to use when creating the new netCDF dataset with the deeper
data generated by this method call.</p>
</dd>
<dt><strong>h_N</strong><span class="classifier">float, default 1.0</span></dt><dd><p>Fraction of the water depth (–) at which to compute the buoyancy
frequency used to extend the profile</p>
</dd>
<dt><strong>h</strong><span class="classifier">float, default 0.01</span></dt><dd><p>Passed to the <cite>buoyancy_frequency()</cite> method.  Fraction of the 
water depth (–) to use as the length-scale in a finite-
difference approximation to the density gradient.</p>
</dd>
<dt><strong>N</strong><span class="classifier">float, default is None</span></dt><dd><p>Optional replacement of <cite>h_N</cite> and <cite>h</cite>, forcing the extension 
method to use <cite>N</cite> as the buoyancy frequency.</p>
</dd>
</dl>
</dd>
</dl>
<div class="admonition seealso">
<p class="admonition-title">See also</p>
<dl class="simple">
<dt><a class="reference internal" href="ambient.Profile.buoyancy_frequency.html#ambient.Profile.buoyancy_frequency" title="ambient.Profile.buoyancy_frequency"><code class="xref py py-obj docutils literal notranslate"><span class="pre">buoyancy_frequency</span></code></a></dt><dd></dd>
</dl>
</div>
<p class="rubric">Notes</p>
<p>This method does not explicitely return a value; however, it does
create a Profile object with a deeper depth.  If this object is 
based on an open netCDF dataset, then this method closes the original 
netCDF dataset in the object, and rebuilds the necessary object 
attributes to be consistent with the new netCDF dataset.  The new 
netCDF dataset filename is provided by <cite>nc_name</cite>.</p>
<p>One may extend a profile any number of ways; this method merely 
provides easy access to one rational method.  If other methods are 
desired, it is recommended to create a new netCDF dataset with the 
desired deeper profile data and then use that dataset to initialize 
a new <cite>Profile</cite> object.</p>
</dd></dl>

</div>


          </div>
          
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
<h1 class="logo"><a href="../../index.html">Texas A&M Oil spill / Outfall Calculator</a></h1>








<h3>Navigation</h3>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="../../user_manual.html">TAMOC User Manual</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../unit_tests.html">Unit Tests</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../glossary.html">Glossary</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../bugs.html">Reporting Bugs</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../readme.html">Read Me File</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../release.html">Release Notes</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../license.html">License</a></li>
</ul>

<div class="relations">
<h3>Related Topics</h3>
<ul>
  <li><a href="../../index.html">Documentation overview</a><ul>
  <li><a href="../../user_manual.html">TAMOC User Manual</a><ul>
  <li><a href="../../modules/ambient.html">Overview of Ambient Module</a><ul>
  <li><a href="ambient.Profile.html">ambient.Profile</a><ul>
      <li>Previous: <a href="ambient.Profile.close_nc.html" title="previous chapter">ambient.Profile.close_nc</a></li>
      <li>Next: <a href="ambient.Profile.get_units.html" title="next chapter">ambient.Profile.get_units</a></li>
  </ul></li>
  </ul></li>
  </ul></li>
  </ul></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
  <h3 id="searchlabel">Quick search</h3>
    <div class="searchformwrapper">
    <form class="search" action="../../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" />
      <input type="submit" value="Go" />
    </form>
    </div>
</div>
<script>$('#searchbox').show(0);</script>








        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="footer">
      &copy;2020, Scott A. Socolofsky.
      
      |
      Powered by <a href="http://sphinx-doc.org/">Sphinx 2.4.4</a>
      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
      
      |
      <a href="../../_sources/autodoc/ambient/ambient.Profile.extend_profile_deeper.rst.txt"
          rel="nofollow">Page source</a>
    </div>

    

    
  </body>
</html>